调用该接口创建一体化以图搜图任务,即同时检索人脸和人体特征的任务。
使用限制
- 单个阿里云账号调用该接口的每秒请求数(QPS)最大限制为100。说明 RAM用户共享阿里云账号配额。
- 请提前在V系列边缘一体机上部署人脸和人体检测算法。
- 请提前为待检索图片,配置URL地址。说明 当前仅支持JPG格式的图片,且图片URL中不能包含中文。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
Action | String | 是 | CreatePictureSearchJob | 系统规定参数。取值:CreatePictureSearchJob。 |
AppInstanceId | String | 是 | 3e429560124b44b685095df81a27**** | 以图搜图应用实例ID。可调用QueryPictureSearchApps接口查询。 |
StartTime | Long | 是 | 1614227915000 | 检索起始时间,格式为13位时间戳,单位为毫秒。 |
EndTime | Long | 是 | 1614327915000 | 检索结束时间,格式为13位时间戳,单位为毫秒。 |
SearchPicUrl | String | 是 | https://example.com/test.jpg | 待检索图片的地址,支持JPG格式的图片,且图片URL不能包含中文。 |
Threshold | Float | 是 | 0.5 | 人脸检索阈值,取值范围为0.0~1.0。 说明 为保证检索结果的准确性,推荐您将该参数的值设置在0.3~0.6之间。 |
BodyThreshold | Float | 否 | 0.9 | 人体检索阈值,取值范围为0.0~1.0。 说明
|
PictureSearchType | Integer | 否 | 1 | 检索类型:
|
调用API时,除了本文介绍的该API的特有请求参数,还需传入公共请求参数。公共请求参数说明,请参见公共参数文档。
返回数据
名称 | 类型 | 示例值 | 描述 |
Code | String | 200 | 接口返回码:
|
Data | String | 71632df011294a85910c566e7181**** | 一体化以图搜图任务ID。 |
ErrorMessage | String | The request has failed due to a temporary failure of the server. | 调用失败时,返回的出错信息。 |
RequestId | String | FAEBE068-07DE-4B88-AC2A-51FC2B556211 | 阿里云为该请求生成的唯一标识符。 |
Success | Boolean | true | 是否调用成功:
|
示例
请求示例
http(s)://linkvisual.cn-shanghai.aliyuncs.com/?Action=CreatePictureSearchJob
&AppInstanceId=3e429560124b44b685095df81a27****
&StartTime=1614227915000
&EndTime=1614327915000
&SearchPicUrl=https://example.com/test.jpg
&Threshold=0.5
&<公共请求参数>
正常返回示例
XML
格式
<CreatePictureSearchJobResponse>
<RequestId>DB14A78C-6F64-40D0-8C03-46E8D57A8FC8</RequestId>
<Data>71632df011294a85910c566e7181****</Data>
<Code>200</Code>
<Success>true</Success>
</CreatePictureSearchJobResponse>
JSON
格式
{
"RequestId": "DB14A78C-6F64-40D0-8C03-46E8D57A8FC8",
"Data": "71632df011294a85910c566e7181****",
"Code": "200",
"Success": true
}
文档内容是否对您有帮助?